Konfiguration für Mehrplatzbetrieb

Die vorausgegangenen Kapitel beschreiben das Verfahren zur Installation und Inbetriebnahme von Alephino auf einem lokalen Windows-Arbeitsplatz. Sollen die Alephino-Dienste im Netzwerk zur Verfügung gestellt werden, sind u.U. weitere Arbeitsschritte zur Konfiguration der Alephino-Komponenten notwendig.
Sofern Sie bereits im entsprechenden Konfigurationsdialog während der Installation den DNS-Namen bzw. die IP-Adresse Ihres Alephino-Servers angegeben haben, brauchen Sie nachfolgend beschriebene Einstellungen nicht zu beachten. Setup hat dies bereits für Sie erledigt.

Konfiguration der Alephino-Anwendungen

Die Alephino-Anwendungen (Clients) benötigen für den Zugriff auf "Ihren" Server Informationen über dessen IP-Adresse und Portnummer. Setup belegt die Adresse mit localhost vor. Sofern Sie nicht während der Installation einen anderen Namen (eine andere Adresse) angegeben haben, gilt auch hier:

Ersetzen Sie localhost jeweils durch die (symbolische) Adresse des Servers.

Bearbeiten Sie die Datei Library.ini im Verzeichnis Alephcom\Tab Ihrer Alephino-Client-Installation (z.B. C:\Programme\ExLibris\AlephinoClients_50).
Beachten Sie unbedingt, daß die Definitionszeilen ein starres Spaltenschema besitzen. Zur Orientierung dient dabei die Kommentarzeile:

!-----------------------------+-----+------------------------------>

Tip:
Noch einfacher geht's mit dem Bibliotheken-Manager; zudem garantiert dieser die formale Korrektheit der Konfigurationsdateien.

Alephino als Windows-Service

Die von Setup erzeugte Programmgruppe des Alephino-Servers enthält folgende Einträge:

Alephino-Server Programmgruppe

Alephino-Programme (mit Ausnahme des Batch-Tools "adm_batch.exe") können unter Windows als sogenannte Services (Dienste) betrieben werden. Die Programme belegen dann im Betrieb kein Konsolenfenster, sondern arbeiten im Hintergrund. Diese Betriebsart bedarf einer Initialisierung, wodurch der neue Dienst dem ServiceControlManager (SCM) bekanntgemacht wird.

Vorgehen:

Melden Sie sich als Administrator an
Wählen Sie aus der Programmgruppe den Eintrag Installieren Alephino als Dienst (bzw. Installieren Z39.50 Gateway als Dienst, Installieren Z39.50 Server als Dienst...)
Unter Systemsteuerung / Dienste erscheint jetzt der Eintrag Alephino 5.0 Server ( bzw. Alephino 5.0 ZGate, Alephino 5.0 ZServer...)
Der Dienst kann jetzt mit den spezifischen Werkzeugen des SCM bedient werden. (Starten, Beenden, Startart ...)

(Analoge Konfigurationsvarianten finden Sie beispielsweise für den HTTP-Server APACHE in dessen Programmgruppe.)

Bitte beachten Sie:

Solange Alephino-Server (bzw. Alephino Z39.50 Gateway, Alephino Z39.50 Server etc.) als Dienst installiert sind, können diese nicht mehr als Konsolenanwendung betrieben werden. Der Start des betreffenden Programmes über den entsprechenden Verweis auf dem Desktop bzw. in der Programmgruppe funktionieren nicht mehr! Sollen die Programme wieder als Konsolenanwendung ablaufen, entfernen Sie zuvor den Service aus dem SCM durch Aufruf von Deinstallieren Alephino als Dienst (bzw. Deinstallieren Z39.50 Gateway als Dienst, Deinstallieren Z39.50 Server als Dienst...). Hierzu sind wiederum Administrator-Rechte notwendig. Nach erfolgreicher Deinstallation verschwindet der entsprechende Eintrag aus der Dienste-Liste.
Der Alephino-Service erzeugt zu Diagnosezwecken Einträge im sog. Ereignisprotokoll. Diese finden sich unter der Kategorie Anwendung. Protokolleinträge werden beim Starten und Beenden sowie beim Auftreten von Fehlern erzeugt.

Einbinden von Alephino in den Boot-Prozeß unter Linux

Soll der Alephino-Server beim System-Start (Boot) und -Beenden (Shutdown) automatisch eingebunden werden, sind nachfolgend beschriebene Arbeitsschritte auszuführen. Diese Anleitung ist für die Linux-Distibutionen von SuSE / Novell und RedHat anwendbar.

Wechseln Sie in das Alephino-Unterverzeichnis bin.

Falls Sie ein SuSE Derivat verwenden, benennen Sie die Datei alephino.rc.suse in alephino.rc um:
mv alephino.rc.suse alephino.rc
Anderenfalls nutzen Sie die gleichfalls von Setup erzeugte Skript-Datei alephino.rc.debian. Diese ist für alle Unix/Linux Derivate geeignet:
mv alephino.rc.debian alephino.rc

Setzen Sie Ausführungsrechte für das Skript alephino.rc:
chmod +x alephino.rc
Melden Sie sich als Root an.

Erzeugen Sie eine Datei /etc/init.d/alephino, z.B.:

#!/bin/sh

# chkconfig: 2345 98 93
# description: Alephino 5.0 Server

/bin/su alephino -c "cd /work/alephino/bin; nohup ./alephino.rc $1"
exit $?

Setzen Sie Ausführungsrechte für das Skript alephino:
chmod +x alephino
Konfigurieren Sie symbolische Links für die definierten Runlevel mit folgendem Aufruf:
chkconfig --add alephino
Testen Sie das Start-Skript im Verzeichnis /etc/init.d:
./alephino start
bzw.
./alephino stop

Aktivieren Sie das Skript schließlich mit:
chkconfig alephino on

Beim nächsten Systemstart sollte nun Ihr Alephino-Server mit gestartet werden; im Verlauf des Bootprozesses erhalten Sie beispielsweise die Meldung:
Starting Alephino 5.0 Server done

Unter Debian und Distributionen, die auf diesem basieren (Ubuntu, Kubuntu ...), unterscheidet sich das Verfahren etwas.
Von obiger Anleitung abweichende Arbeitsschritte sind:

Erzeugen Sie eine Datei /etc/init.d/alephino, z.B.:

#!/bin/sh
### BEGIN INIT INFO
# Provides:          alephino
# Required-Start:    $local_fs $network $syslog
# Required-Stop:     $local_fs $network $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start/stop ExLibris alephino service
### END INIT INFO

/bin/su alephino -c "cd /work/alephino/bin; nohup ./alephino.rc $1"
exit $?

Setzen Sie Ausführungsrechte für das Skript alephino:
chmod +x alephino
Konfigurieren Sie symbolische Links für die definierten Runlevel mit folgendem Aufruf:
update-rc.d alephino defaults
Testen Sie das Start-Skript im Verzeichnis /etc/init.d:
./alephino start
bzw.
./alephino stop

Ausgaben des Alephino-Servers werden in die Datei ../temp/alephino.out umgeleitet, Sollte Ihr Alephino-Server nicht starten, finden Sie hier ggfs. eine entsprechende Fehlermeldung.

Alephino-Dienste via Web administrieren

Das Administration-Modul der vorliegenden Alephino-Version erlaubt es, via Web-Browser Dienste wie Datensicherung und -wiederherstellung zu starten, Generierungsdateien und Parameter zu bearbeiten, Benutzer zu administrieren, Server und Gateway zu beenden und anderes mehr. Zudem besteht die Möglichkeit, Alephino-Server und Alephino Z39.50 Gateway aus der Web-Oberfläche zu starten. Dies ist einerseits sehr komfortabel, braucht sich der Anwender nicht mit einer Terminal-Emulation (telnet, putty u.ä.) und der Unix-Kommandosyntax (Shell) auseinanderzusetzen, birgt aber andererseits auch Gefahren für die Systemsicherheit. Dies gilt insbesondere dann, wenn der Server via HTTP über das Internet erreichbar ist.
Unsere Empfehlung ist es daher, mindestens den mit Apache verfügbaren Zugriffsschutz für kritische Alephino-Dienste zu installieren. Das folgende Kapitel zeigt eine einfache Konfigurationsvariante hierfür auf, die der Apache-Dokumentation entnommen wurde.

1) Einrichten eines Passwortschutzes für Web-Administration

Der von Setup erzeugte virtuelle Host enthält bereits den fett markierten Definitionsblock in auskommentierter Form, z.B.:
vhost.alephino

# Ports for Alephino Services
Listen 8060
Listen 8030

# Alephino OPAC
<VirtualHost *:8060>
ScriptAlias /alipac "/work/alephino/bin/alipac"
ErrorLog "/work/alephino/temp/alipac_error.log"
TransferLog "/work/alephino/temp/alipac_access.log"
Alias /download "/work/alephino/temp"
Alias /pix "/work/alephino/htdoc"
</VirtualHost>

# Alephino Administration
<VirtualHost *:8030>
Alias /german "/work/alephino/htdoc/aliadm_ger"
Alias /english "/work/alephino/htdoc/aliadm_eng"
ScriptAlias /aliadm "/work/alephino/bin/aliadm"
ScriptAlias /aliadz "/work/alephino/bin/aliadz"
ErrorLog "/work/alephino/temp/aliadm_error.log"
TransferLog "/work/alephino/temp/aliadm_access.log"

# Authentication
#<Directory "/work/alephino/bin">
#AllowOverride AuthConfig
#AuthType Basic
#AuthName "Alephino Administration"
#AuthUserFile /work/alephino/passwords
#Require user alephino
#</Directory>

</VirtualHost>
Entfernen Sie im markierten Bereich jeweils das # am Zeilenanfang.
Erzeugen Sie eine Passwortdatei mit dem zu Apache gelieferten Werkzeug htpasswd, welches sich üblicherweise im Apache-Unterverzeichnis bin befindet:
./htpasswd -c /work/alephino/passwords alephino
(Der Pfadname der Passwortdatei /work/alephino/passwords sowie der Benutzername alephino sind als Beispiele zu verstehen.)
Um diese Konfigurationsänderung wirksam werden zu lassen, starten Sie Ihren Apache neu:
./apachectl restart
Fortan erscheint beim ersten Versuch, einen Dienst aus der Web-Administration auszuwählen, eine (browserspezifisch gestaltete) Eingabemaske der Form:

2) Alephino-Server via Browser starten

Im Unterverzeichnis bin Ihrer Alephino-Installation finden Sie hierzu ein Shell-Skript cgistart bzw. (für Windows) eine Batch-Datei cgistart.bat.

Stellen Sie sicher, dass dieses Skript Ausführungsrechte besitzten (nur Unix/Linux):
chmod ug+x cgi*
Fügen Sie in den von Setup erzeugten Definitionsblock für den virtuellen Host "Alephino Administration" die markierten Zeilen ein, z.B.:
vhost.alephino

# Alephino OPAC
...
# Alephino Administration
<VirtualHost *:8030>
Alias /german "/work/alephino/htdoc/aliadm_ger"
Alias /english "/work/alephino/htdoc/aliadm_eng"
ScriptAlias /aliadm "/work/alephino/bin/aliadm(.exe)"
ScriptAlias /aliadz "/work/alephino/bin/aliadz(.exe)"
ScriptAlias /cgistart "/work/alephino/bin/cgistart(.bat)"
ErrorLog "/work/alephino/temp/aliadm_error.log"
TransferLog "/work/alephino/temp/aliadm_access.log"

...
</VirtualHost>
Bitte beachten Sie unbedingt, dass:
- Pfadangaben anzupassen sind; Windows-Pfadnamen müssen beispielsweise mit einem Laufwerks-Buchstaben, gefolgt von einem Doppelpunkt, beginnen,
- Unter Windows entsprechend den dortigen Namenskonventionen ausführbare binäre Dateien die Endung .exe sowie Batch-Dateien die Endung .bat erhalten müssen,
- Das Verfahren unter Windows nur dann funktioniert, wenn der Alephino-Server als Service installiert wurde.